home *** CD-ROM | disk | FTP | other *** search
/ Info-Mac 4 / Info_Mac IV CD-ROM (Pacific HiTech Inc.)(August 1994).iso / Development / General / Script Tools / Read Me First next >
Text File  |  1994-05-06  |  6KB  |  150 lines
  1.                               Script Tools 1.3-1
  2.                              Copyright © 1993-1994
  3.                       Mark Alldritt All Rights Reserved
  4.  
  5. This package contains a series of AppleScript additions which add functionality
  6. to the AppleScript language.  Version 1.3-1 of Script Tools adds the following
  7. commands to AppleScript:
  8.  
  9.     Choose Folder           This command presents a standard file selection
  10.                             dialog which allows the user to select a folder.
  11.  
  12.     Choose New File         This command presents a standard file selection
  13.                             dialog permitting the user to name a new file.
  14.  
  15.     Choose Several Files    This command presents a modified standard file
  16.                             selection dialog box allowing the user to choose
  17.                             several files at one time.
  18.  
  19.     Choose Several Folders  This command is similar to Choose Several Files
  20.                             except that it permits the selection of folders
  21.                             instead of files.
  22.  
  23.     Get Default Folder
  24.     Set Default Folder      These two commands allow your scripts to get and
  25.                             set the default folder and volume used in Choose
  26.                             File and Folder commands.
  27.  
  28.     Shutdown                Shuts down and optionally restarts the Macintosh
  29.  
  30.     Compile Regular Expression
  31.     Match Regular Expression
  32.     Substitute Regular Expression
  33.                             These three commands allow you to perform text
  34.                             pattern matching operations within AppleScript.
  35.  
  36.     Open File, Close File, Create File, Create Folder, Delete File
  37.     Rename File, Exchange File, Move File
  38.     Read File, Write File
  39.     Get File Length, Lengthen File
  40.     Get File Position, Position File
  41.                             This series of commands allows your AppleScript
  42.                             scripts to manipulate files.
  43.  
  44.     List Processes, Get Process,
  45.     Get Foreground Process,
  46.     Get Current Process        This series of commands allows you write scripts
  47.                             that manipulate running applications.
  48.                             
  49.     List Screens            Obtains a list of the display screens attached
  50.                             to the Macintosh.
  51.  
  52.     Speak, List Voices, Get Voice
  53.                             This series of commands allows you to write
  54.                             AppleScript scripts which use the Apple Speech
  55.                             Manager to say text messages.
  56.  
  57.     Get Gestalt             Accesses Gestalt information
  58.  
  59. The package also contains some example AppleScript scripts which illustrate
  60. the use of these commands.
  61.  
  62.  
  63. Requirements:
  64.  
  65. You must have System 7 or later and AppleScript 1.0 or later installed on your
  66. Macintosh to make use of the software in this package.  A Word Processor 
  67. capable of reading MS Word 5 format files is required to display the
  68. documentation (you can also use the Open Dictionary command in the AppleScript
  69. Script Editor to view a breif descrition of each Script Tools command).
  70.     Apple's Speech Manager is required to use the Speak, List Voices, and Get
  71. Voice commands.
  72.  
  73.  
  74.     * * *  This package does NOT contain the AppleScript software  * * *
  75.     * * *  This package does NOT contain the Speech Manager software * * *
  76.  
  77.  
  78. Using & Copying Script Tools:
  79.  
  80. Script Tools is freeware for personal use.  Please feel free to distribute
  81. Script Tools to friends and colleagues. However, Script Tools may not appear
  82. as part of any promotional offer or commercial product without the author's
  83. expressed written permission.  Commercial re-distrbution licences are available
  84. at a modest price through the author.
  85.     When distributing Script Tools, please distribute the entire package as you
  86. received it.  
  87.  
  88.  
  89. Installation:
  90.  
  91. To install Script Tools copy the contents of the Additions folder to the
  92. Scripting Additions folder within the Extensions folder in your System Folder.
  93.  
  94.  
  95. Upgrading:
  96.  
  97. Script Tools 1.3 introduces changes which will effect your existing scripts.
  98. The definition of the reply record returned by the Choose New File command has
  99. been changed.  The name returned field has been changed to filename returned.
  100. This change was made to avoid terminology conflicts with StuffIt Deluxe.
  101.  
  102.  
  103. Version History:
  104.  
  105. Version 1.3-1 May 1994
  106. - Corrected a memory management problem in the Regular Expressions Addition
  107. - A problem with the Speak command where it would speak the only the first
  108.   255 characters of any string passed to it has been corrected.
  109. - Updated me E-mail address
  110.  
  111. Version 1.3-0 September 1993
  112. - Addition of the Create Folder command
  113. - Change terminology for the Choose New File command to avoid a conflict with
  114.   StuffIt Deluxe
  115.  
  116. Version 1.2-0 September 1993
  117. - Addition of the Speak, List Voices, Get Voice, Get Gestalt, Rename File,
  118.   Exchange File, Move File, List Processes, Get Process, Get Current Process,
  119.   Get Foreground Process and List Screens commands
  120. - Corrected a bug in the Create File command which limited path names to 63
  121.   characters.  The limit is now 255 characters
  122. - New example scripts for some of the new commands
  123. - Addition of the gestalt Selector Lib file which defines all the Gestalt
  124.   selectors documented in Inside Mac VI
  125. - Updated documentation now describes all the ScriptTools commands
  126.  
  127. Version 1.1-0 July 1993
  128. - Addition of the Shutdown, Regular Expression and File IO Additions to the
  129.   package
  130. - Addition of new example scripts
  131.  
  132. Version 1.0-0 June 1993
  133. - First public release of Script Tools
  134.  
  135.  
  136. Contact Information:
  137.  
  138. Please send all registrations, comments, questions or suggestions to me at
  139. the following address:
  140.  
  141.     Mark Alldritt
  142.     1571 Deep Cove Road
  143.     North Vancouver, B.C.
  144.     CANADA  V7G-1S4
  145.  
  146.     alldritt@wimsey.com
  147.  
  148. My e-mail address changed at the beginning of 1994.  If you have been trying to
  149. reach me since then, I have not received your messages.  I apologize for not
  150. responding to any quiries you may have made.